home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 4 / Gold Medal Software - Volume 4 (Gold Medal) (1994).iso / utils1 / fh103.arj / FH.DOC next >
Text File  |  1994-08-05  |  37KB  |  1,062 lines

  1.  
  2. ┌────────────────────────────┬───────────────────┐
  3. │ FILE HANDLER SYSTEM  v1.03 │ by Mark Bloss     │
  4. └────────────────────────────┴───────────────────┘
  5.  
  6.  Copyright (c) 1994    All Rights Reserved.
  7.  
  8. ┌────────────────────────┐
  9. │ WHAT IS FILE HANDLER?  │
  10. └────────────────────────┘
  11.  
  12. File Handler, or FH, is an interface between you,
  13. and your computer.  It allows you easy and
  14. intuitive access to every file and directory on
  15. your system.  It can delete, copy, move, change
  16. attribute flags, stamp the time and date, rename,
  17. and view files.  FH has the ability to execute
  18. external programs.  It has the capability to search
  19. for a file "mask" such as "*.BAK" or any other
  20. normal wildcard combination, flag these files for
  21. some action, and then let you delete all of
  22. them, or just some of them in particular
  23. directories, or to copy them or move them to a
  24. common location.  FH also makes and removes
  25. directories.
  26.  
  27. FH is completely configurable with command-line
  28. switches, built-in color configuration and
  29. program setting configuration.  Among them are
  30. whether or not you want access to files which have
  31. the "hidden" and "system" attributes set, whether
  32. you prefer ALL CAPS or Mixed Case display of
  33. filenames, whether you prefer a wide format, or
  34. single column format, (there is a Toggle "hot-key"
  35. which switches this mode back and forth).  And
  36. several other noted features, with both command-line
  37. and internal configurable settings.
  38. It allows the user to execute external programs,
  39. including a user-written batch file which will execute
  40. at the press of a single "hot-key" combination.  Plus,
  41. it has a "screen-saver" and context-sensitive help
  42. screens.
  43.  
  44.  
  45. ┌────────────────────────┐
  46. │ DISCLAIMER             │
  47. └────────────────────────┘
  48.  
  49. This Program has been Copyrighted.
  50. All Rights have been Reserved.
  51.  
  52. I take no responsibility for anything, and if
  53. anything you do with this program ruins your life
  54. or makes your roof leak, or anything else, that's
  55. just too bad.
  56.  
  57. Further, I do not guarantee the fitness of this
  58. program for any specific use, other than taking
  59. up disk space.  This program is capable of
  60. deleting files, which may or may not be required
  61. to use your computer.  You are responsible for
  62. any damage you do to your system, if this program
  63. is used, or misused.  Please read the instructions
  64. carefully, and take the time to learn how to use
  65. File Handler to its fullest potential.
  66.  
  67.  
  68. ┌─────────────────────────────────────────────────┐
  69. │ REGISTRATION AND DISTRIBUTION POLICIES          │
  70. └─────────────────────────────────────────────────┘
  71.  
  72. This program is Shareware.  You are given a limited
  73. license to use this program for a period of about
  74. thirty days, after that you must register the program 
  75. in order to continue using it.  
  76.  
  77. This program is not hindered in any way from functioning
  78. completely as designed.  I don't believe in "nag reminders"
  79. or crippling my software in any way.  If you appreciate 
  80. that in a programmer, please show your support by
  81. registering the program. 
  82.  
  83. If you enjoy using this program and want others to
  84. have it, you may distribute it.  However, there is
  85. such a thing as a "registered" copy of this
  86. program, and you must not distribute any
  87. "registered" copies!  The notice in the program
  88. which determines the registration status of the
  89. program is on the opening screen.  If you do not
  90. have a registered copy, you will see the words,
  91. "░UNREGISTERED COPY░" prominently displayed in the
  92. initial Copyright notice.
  93.  
  94.  
  95. If you do distribute the program:
  96.  
  97. You MUST distribute "FHxxx.ZIP" EXACTLY AS IT CAME
  98. TO YOU, including this documentation.  The internal
  99. self-extracting files must be left "as is". You must
  100. also keep the naming convention used in the copy you
  101. received.
  102.  
  103. (ie."FHXxx.", where X=Major version, xx=minor version)   
  104.  
  105.  
  106. If you become suspicious of anything after having
  107. checked this program, you should let me know, and
  108. the Sysop of the BBS from which you downloaded this
  109. program.  I have no further responsibility for what
  110. happens to this archive after it leaves my PC.  You
  111. can always get a fresh copy directly from one of the
  112. Official Distribution Sites (ODS's) listed at the end 
  113. of this documentation. 
  114.  
  115.  
  116. ┌─────────────────┐
  117. │ HOW TO REGISTER │
  118. └─────────────────┘
  119.  
  120. Write me at the address at the end of this document.
  121. You may include your suggestions, bug reports, and
  122. likes and dislikes, and send a check or money order.
  123. The price is a very reasonable $20.00 for each copy.
  124. The benefit of registering is receipt of a registered 
  125. copy of this program, licensed for your own use for
  126. an indefinate period of time. You will also receive 
  127. technical support and be given priority when you pass
  128. along any suggestions and bug reports.  Any bug report
  129. from a registered user will earn a free upgrade and
  130. your name may be mentioned in my documentation.   
  131.  
  132. If you intend to use this program in a business or
  133. government agency, you MUST register the program
  134. with the author.  The fee for business or
  135. government use is $50.00 per workstation.
  136.  
  137. Registered copies have commenced to be distributed
  138. as of Version 1.00.  At no time whatsoever, are 
  139. registered copies of the program to be distributed!
  140.  
  141. Please send payment and/or correspondence to my
  142. address below.  If you send me notes via e-mail,
  143. be certain you note the correct address given
  144. below.  Checks, or money-orders, should be made
  145. out to me: Mark Bloss.
  146.  
  147. I may send you more details through the mail, and I
  148. will answer correspondence, either Postal or E-
  149. Mail.   If you want your registered copy through
  150. the mail, please include an additional $3.00 per
  151. diskette, and include whether you want 5.25 or 3.5
  152. inch diskettes.
  153.  
  154. All prices and fees are subject to change without
  155. notice.
  156.  
  157. Business and Goverment Use:    $50.00 per diskette, with no handling charges,
  158.                                for up to thirty separate copies.
  159.                                31 or more is $30.00 per copy.  For very large
  160.                                orders, of 100 or more licences and copies,
  161.                                there is an additional one-time charge of
  162.                                $15.00 to defray postage costs.
  163.  
  164.  
  165. Individual Users:              $20.00 plus $3.00 handling for each copy.
  166.                                There is no limit on the number of copies an
  167.                                individual may register.  The $3.00 handling
  168.                                charge is waived for more than 10 copies.
  169.  
  170.  
  171. ┌─────────────────────────┐
  172. │ INSTALLATION            │
  173. └─────────────────────────┘
  174.  
  175. For a quick start, find the line with %%%%%%%%% below.
  176.  
  177. File Handler was designed for the experienced user.
  178. However, anyone can learn to use FH with little or
  179. no experience.
  180.  
  181.  
  182. FH runs from a batch file called FH.BAT, which is
  183. created by the installation program, INSTALL.COM.
  184.  
  185. The installation program will NOT change your
  186. AUTOEXEC.BAT or CONFIG.SYS files, or any other
  187. start-up files you may have specified.
  188.  
  189. If you would like to use File Handler as a Menu/Shell
  190. style program, you may include the line:
  191.  
  192. FH.BAT [param1] [param2] [etc]
  193.  
  194. on the last line of your AUTOEXEC.BAT file.
  195.  
  196. Since you are reading this document, I assume you have
  197. already discovered how to unarchive the "outer" archive.
  198. You should have on your disk, this file: FH.DOC, then
  199. FILE_ID.DIZ, FHEX.INS, FHINST.INS, INSTALL.COM and
  200. README.1ST.
  201.  
  202.  
  203. The directory you choose to unarchive the main or
  204. "outer" archive does not have to be the "final"
  205. directory in which FH is to be installed.  A temporary
  206. directory, or the root directory, will serve just
  207. fine.
  208.  
  209.  
  210. IMPORTANT!!!!!
  211. Please be certain you are logged into the directory where
  212. you un-archived FHxxx.ZIP before running the INSTALL
  213. program.  The files FHEX.INS and FHINST.INS will be deleted
  214. upon a successful installation.
  215.  
  216. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  217.  
  218. Key "INSTALL" [enter] at the "DOS" prompt.  INSTALL
  219. will ask you, first, for the directory in which you want
  220. the program files to reside.  They will be FHMAIN.COM,
  221. FH.000, FH.001, FH.HLP and FH.CFG.  Additional files will
  222. be copied to this directory also, such as FH.DOC, but
  223. they are not essential for the program to operate.
  224. After that, INSTALL will ask you where you want it to
  225. create the FH.BAT file mentioned earlier.  You will want
  226. to tell it to create this file somewhere along your PATH.
  227. (See your Operating Systems' documentation for more about
  228. the PATH environment variable.) The default is to place
  229. FH.BAT within the root directory of the currently logged
  230. drive.
  231.  
  232. Once you have finished running INSTALL, you should
  233. get a message that the installation was successful.
  234. If not you will receive a short message hinting
  235. at what may have happened.  If you do receive one
  236. of the error messages, run INSTALL again.  Be
  237. certain the directory paths are valid.
  238.  
  239.  
  240. It is recommended that you keep the original archive
  241. in the event you ever need to re-install the program,
  242. and for passing along to your friends.
  243.  
  244.  
  245. ┌────────────────┐
  246. │ TO START FH... │
  247. └────────────────┘
  248.  
  249.  
  250. After you receive a successful response from the
  251. installation procedures, you may enter "FH" at the
  252. DOS prompt to start File Handler.
  253.  
  254. You should familiarize yourself with File Handler,
  255. and configure your permanent settings from inside
  256. FH before depending on the command-line switches.
  257.  
  258. The reason for this, is that most of the command-line
  259. switches are used to override, for a single session, the
  260. settings you have configured from within File Handler.
  261.  
  262.  
  263. However, COMMAND-LINE SWITCHES are explained when you
  264. request help from the command-line, with "FH /?".
  265.  
  266.  
  267. You may edit the FH.BAT file to include the
  268. ones you will be using all the time.  The line
  269. to edit within FH.BAT will look like this:
  270.  
  271.  
  272. %FHDIR%\fhmain.exe @%FHDIR% %1 %2 %3 %4 %5 %6 %7 %8 %9
  273.  
  274.  
  275. Push the %1 over to add additional commands.  If you
  276. wanted to add the parameter "-M" as a permanent
  277. setting, you would change the line to look like this:
  278.  
  279.  
  280. %FHDIR%\fhmain.exe @%FHDIR% -M %1 %2 %3 %4 %5 %6 %7 %8 %9
  281.                             ^^
  282.  
  283. "-M" is used for allowing MONOCHROME monitors to use FH
  284. without making it impossible to read the screen.  This
  285. particular command-line switch is NOT in the program
  286. configuration, so you would want to add this command-
  287. switch to FH.BAT.
  288.  
  289. One of the configuration settings include the so-called
  290. "Directory-Exit" setting.  This tells FH whether you want
  291. FH to exit to the directory you started FH from, or exit
  292. to the directory you are currently logged to when you
  293. press the [esc] key to exit the program.  However you have
  294. this set, there is a command-line switch to override this
  295. setting, and you can override that from within FH by using
  296. the hot-key [alt-x] to exit the program instead.
  297.  
  298. A single backslash "\" on the command-line, will force
  299. FH to begin at the root directory of the currently logged
  300. drive.  You would still exit according to your configuration,
  301. however.  For instance, if you have "directory exit" configured
  302. to exit normally to the directory you are logged to when
  303. exiting with the [esc] key, then you will exit to that
  304. directory, regardless of where you started from.  But, if you
  305. have it set to exit to the original directory, you will not
  306. exit to the root directory if you placed the "\" on the
  307. command-line, unless you were actually logged to the root
  308. directory anyway.  Instead you would return to the drive
  309. and path from which you actually invoked File Handler.
  310.  
  311.  
  312.    Use the command-line switch "/?" for more
  313.    information about the command-line switches.
  314.  
  315.  
  316. FH is designed for computers with at least one Hard Drive
  317. installed.  However it is possible to use FH on floppy-only
  318. systems, but it is not recommended.
  319.  
  320. If you ever have difficulty getting FH to run, something
  321. may have damaged the FH.CFG file. In which case you should
  322. delete that file and start FH again.  You do NOT have to
  323. re-install the entire program, unless something happens
  324. to the program files themselves.
  325.  
  326. If you totally screw-up your colors, you can start over
  327. by deleting the FH.CFG file, also.  Then FH will begin
  328. with a fresh FH.CFG with the default settings in place.
  329.  
  330. If you delete or lose the FH.BAT file, you will have to
  331. re-install FH from the original archive.
  332.  
  333.  
  334. ┌────────────────────────┐
  335. │ TAGGING FILES          │
  336. └────────────────────────┘
  337.  
  338.  
  339. One of the first things to know, in order to enjoy
  340. File Handler is knowing how and when to select files.
  341. Selecting, or tagging files is simple to accomplish
  342. one at a time, or using wildcard combinations.
  343.  
  344. The opening screen (the MAIN screen) allows the
  345. tagging of files by moving the pointer with the
  346. arrow keys to the filename and pressing enter.
  347. Pressing enter on a tagged file, untags it.
  348.  
  349.  
  350. The "hot key", [alt-l], allows you to tag multiple
  351. files, and [alt-u] untags everything.  You cannot
  352. tag directories.  If you place the pointer on a
  353. directory's name and press enter, you change to
  354. that directory.  If you have files tagged, you
  355. are warned that changing directories will untag
  356. your files.
  357.  
  358.  
  359. If the program is unable to act on all the files
  360. you have tagged, it retains the tags on the files
  361. it was unable to act upon.  If you run out of space
  362. on your floppy disk while copying multiple files,
  363. you can pick-up where you left off.  If you have
  364. tagged files, and enter the program configuration,
  365. the tags are re-establish when you return.
  366.  
  367.  
  368. Changing directories, or drives, will untag any
  369. files already tagged, but the program will allow
  370. you to answer [N]o to continue.
  371.  
  372.  
  373. In order for you to rename, delete, copy, move,
  374. stamp a file with time and/or date, or change the
  375. attributes of files, or view files, you must tag
  376. the files you want to act upon first.
  377.  
  378.  
  379. If you ever run into a snag, or simply can't figure
  380. out what to do next, always try the [F1] key.  Help
  381. is available from the Main Screen, the Action Menu,
  382. the Color Configuration Menu, the Program Config
  383. Menu, as well as while viewing a file, and while in
  384. the Search Files Utility, and many other places as
  385. well.
  386.  
  387.  
  388.  
  389.  
  390. ┌────────────────────────┐
  391. │ OOPSIES                │
  392. └────────────────────────┘
  393.  
  394.  
  395. Anything and everything you want to abort or exit
  396. is done with the [esc] key.  You exit the program
  397. with [esc] as well.
  398.  
  399.  
  400.  
  401.  
  402. ┌────────────────────────┐
  403. │ DELETING FILES         │
  404. └────────────────────────┘
  405.  
  406.  
  407. You will enjoy being able to coast through your
  408. hard drives' directories, and getting rid of
  409. unneeded files quickly and efficiently without
  410. being confused with dozens of menus.  After tagging
  411. files, press [alt-d] and you will be prompted with a
  412. list of the files you have tagged to delete, and you
  413. may answer [N]o to abort, or [Y]es to proceed with
  414. deleting the tagged files.  Once you press [Y]es...
  415. it's too late to change your mind.
  416.  
  417.  
  418. FH has no UNdelete facility, so it would be to your
  419. advantage to become familiar with such a utility,
  420. such as IBM-DOS's excellent UNDELETE program, just in
  421. case.
  422.  
  423.  
  424.  
  425. ┌────────────────────────┐
  426. │ SPECIAL ATTRIBUTES     │
  427. └────────────────────────┘
  428.  
  429.  
  430. There are two places FH takes file attributes into
  431. account.  One is done automatically, and the other
  432. is user configurable.
  433.  
  434.  
  435. The program will allow you to exclude files which
  436. have special attributes such as hidden files or
  437. system files.  Read-only files can always be "seen"
  438. by your program, but to copy, delete, or move files
  439. which are Read-only, you must have the program's
  440. configuration set to act on ALL FILES.
  441.  
  442.  
  443. The default setting is to exclude system and hidden
  444. files, thereby disabling the Change Attribute
  445. facility as well.  This setting can be changed in
  446. the Program Settings Menu.  You go there from the
  447. MAIN Screen by pressing [F3] twice.
  448.  
  449.  
  450. Once you have ALL FILES set, you will be able to
  451. use the Change Attribute section of the program.
  452. And you will be forced to do so, if you want to
  453. delete files which are Read-Only.  Also, hidden and
  454. system files will be accessible, but there is no
  455. need to change their attributes in order to delete,
  456. copy or move them.
  457.  
  458.  
  459. FH handles the attributes of files you copy or move
  460. according to how you have "attribute handling" set
  461. in the configuration.
  462.  
  463. Normally, if you copy or move a file with FH, it
  464. automatically restores the original attribute byte
  465. to its original state in the destination copy.  You
  466. may configure FH not to restore the original
  467. attribute byte of files by choosing "reset
  468. attributes".
  469.  
  470. The new file will have only the "Attribute"
  471. attribute set, to indicate that the file has been
  472. created (or altered) since the last backup was
  473. made, generally speaking.  Otherwise, after the
  474. copy or move, the destination-file will have its
  475. attribute set to the attribute of the original
  476. source-file.
  477.  
  478.  
  479. An important point about this, is that some disks,
  480. CD-ROMS included, are write-protected, and
  481. therefore, FH will be unable to change the
  482. attribute flag before a copy or move.  This becomes
  483. critical when attempting to copy a hidden, system,
  484. and/or read-only file from a CD or write-protected
  485. diskette.  The Critical Error Handler installed
  486. catches most of these instances, and you will have
  487. to amend whatever it is you are trying to accomplish
  488. in order to avoid the error.  FH depends on its
  489. built-in ability to alter the attribute flagbyte
  490. of a file such as this, before attempting to
  491. move it, or copy it, in order to avoid DOS's strict
  492. protections placed on these files.  FH cannot
  493. change a write-protected diskette in any way.  When
  494. you realize that this is the whole purpose of
  495. write-protection, then I believe you will forgive
  496. this minor inconvenience.
  497.  
  498.  
  499. Some files are protected by File Handler from being
  500. MOVED or DELETED, such as IBMDOS.COM, IBMBIO.COM,
  501. MSDOS.SYS, IO.SYS, DRBDOS.SYS, DRBIOS.SYS,
  502. SYSTEM.INI and WIN.INI.  These are System files
  503. needed by IBM-DOS, MS-DOS, and DRDOS, as well as
  504. third-party OS vendors such as 4DOS, NDOS, and
  505. WINDOWS.
  506.  
  507. Moving these files would be catastrophic, because
  508. doing so would likely force you to have to re-format
  509. your hard drive.  You can add to the default files
  510. list by entering filenames in the "user excluded"
  511. area in the program configuration.  One recommended
  512. addition would be COMMAND.COM or other Command
  513. Processor you use with your system, also AUTOEXEC.BAT
  514. and CONFIG.SYS are good choices to include in your
  515. list.
  516.  
  517.  
  518. FH.BAT, FHMAIN.EXE, and FH.HLP are also protected in
  519. this way. You may define up to 18 additional files 
  520. by including them in your "user excluded" list.
  521.  
  522.  
  523. Moving or deleting the FH program files themselves
  524. from within FH would be foolish at least, because
  525. your system WILL hang, forcing you to reboot. Since
  526. the program might not have even finished writing
  527. to your hard drive when, suddenly the program file no
  528. longer exists.  This could cause damage to your hard
  529. drive.  If you have more than one copy of the FH
  530. program file, and you want to delete the copy
  531. that isn't being used, you may rename the files
  532. first, then delete them.  This is the only way
  533. to circumvent FH's protective measures, but you do
  534. so at your own risk.
  535.  
  536.  
  537.  
  538. ┌─────────────────────────┐
  539. │ CHANGE ATTRIBUTES       │
  540. └─────────────────────────┘
  541.  
  542.  
  543. In order to alter the attributes of files, you
  544. must have "ALL FILES" set in the program
  545. configuration.
  546.  
  547. Once you have this option enabled, you may tag
  548. the files you need to change the attributes of,
  549. and press [alt-a].  A mini-menu appears which
  550. is very simple to use.  The filename will be
  551. shown in the left of the box, and each choice:
  552. Attribute, Hidden, System, and Read-Only, is
  553. written below it.  If the file at hand has
  554. a certain bit set, it will indicate that with
  555. a checkmark (√) underneath that choice.  To
  556. toggle one of the choices on or off, press the
  557. highlighted key: A,H,S,or R.  Once you have
  558. selected which attributes you want for that
  559. file, press enter and the next file will come
  560. up.  You will return to the Main screen when
  561. all your tagged files have been processed.
  562.  
  563. Be certain of your reasons for changing attributes.
  564. Some .EXE's are self-altering, and changing
  565. these type files to Read-only would be unwise.
  566.  
  567. When hiding executables, you must henceforth enter
  568. its fully-qualified-filename-specification,
  569. including extension and directory-path before
  570. running that program, unless logged to its
  571. path-location.  Its existence in a directory
  572. in your PATH environment variable is insufficient
  573. once it is hidden.
  574.  
  575.  
  576. ┌────────────────────────┐
  577. │ TYPING FILES (VIEW)    │
  578. └────────────────────────┘
  579.  
  580.  
  581.  
  582. Viewing files which are not text files are
  583. automatically filtered of unprintables.
  584. First, tag the file(s) you want to view, then
  585. press the "hot-key" [alt-t].  Each file is
  586. brought up in the order shown on the Main screen.
  587.  
  588. While viewing a file, if you choose to keep the tag
  589. on that file, press [F10].  Pressing [esc] will
  590. return you to the Main Screen, and the tag will
  591. still be in effect for that file.
  592.  
  593. To view the next file which you have tagged, press
  594. [enter] and the next file will be viewable.
  595.  
  596. The [pgup] and [pgdn] keys let you move back and forth
  597. through the file.  This particular View procedure isn't
  598. fancy, it truncates lines at 80 characters wide, but it
  599. will allow you to view any size file, as long as it can
  600. fit on your "Workdrive".
  601.  
  602. You set the "Workdrive" for this and other procedures to
  603. use, in the program configuration.
  604.  
  605.  
  606.  
  607. ┌──────────────────────┐
  608. │ COPYING AND MOVING   │
  609. └──────────────────────┘
  610.  
  611.  
  612. Copying files is straightforward as well. Select
  613. the files you want to copy, press [alt-c], enter
  614. the destination directory and press enter.
  615.  
  616. Copy-with-rename is allowed only on a file-by-file
  617. basis.  A plurality of tagged files cannot be
  618. renamed with the copy or move procedure.
  619.  
  620.  
  621. The program has an exclusive optimizing code for
  622. the most efficient use of disk-space, especially
  623. pertaining to floppy disks.  FH has the ability
  624. to fill floppies to maximum capacity automatically.
  625. Simply tag all of the files you want to copy,
  626. and press [alt-c].  When the program encounters a
  627. file too large to fit in the space left on the
  628. diskette, you are asked to continue with other
  629. files, or abort.  Continuing will try the next
  630. file, etc, until there aren't any more files
  631. that will fit, or you press [N]o.  Either [Y] or [N]
  632. will leave the files tagged which were not copied.
  633. If you know you want to continue with another diskette,
  634. insert your next floppy and press [Y]es.  Use the
  635. [esc] key if you want to completely abort the copy
  636. procedure, untagging all remaining files.
  637.  
  638.  
  639. If "retain attributes" option is set in the program
  640. configuration, then the attributes of the files being
  641. copied will be duplicated on the destination files.
  642. The same is true when moving files as well.
  643.  
  644.  
  645. Moving files is exactly like copying.  Except that
  646. the source files will no longer exist after the move.
  647. It can move files across drives as well.  Files
  648. generally moved from one directory to another are
  649. simply updated in the FAT of your drive, while
  650. occasionally files will be copied instead, and
  651. then the original file(s) will be deleted after
  652. a successful copy.
  653.  
  654.  
  655.  
  656. ┌──────────────────────────┐
  657. │ RENAMING FILES           │
  658. └──────────────────────────┘
  659.  
  660.  
  661. Renaming files is handled just like the rest, for
  662. consistency.  You tag the files you want to rename,
  663. and press [alt-r].  You are prompted to enter a new
  664. filename for each file you have tagged.
  665.  
  666.  
  667.  
  668.  
  669. ┌──────────────────────────┐
  670. │ FILE STAMPING            │
  671. └──────────────────────────┘
  672.  
  673.  
  674. As in most of the other functions, tag the file(s)
  675. on which you want to change the time/date stamp.
  676. Then use [alt-p] to bring up the dialog window.
  677. It will show the name of the first file queued to be
  678. stamped, with the date of the file.  You may change
  679. the date, or press [esc] to accept the current date
  680. showing.  As soon as you have changed or accepted the
  681. date, the time is prompted for.  You then do the same:
  682. key a new time, or [esc] to accept the current time
  683. showing.
  684.  
  685.  
  686. If you make a mistake, you have to go back in and
  687. rerun the File Stamp on that file again.  You do
  688. NOT press [enter].  Each field is recorded, the
  689. instant you key a field in.  A little practice with
  690. this, and you will become comfortable with the
  691. input-method.
  692.  
  693.  
  694. This feature is included in FH because of the
  695. suggestion of Gene Tucker of Peripheral Vision BBS
  696. in Nashville Tn.  Thanks Gene.
  697.  
  698.  
  699.  
  700.  
  701. ┌────────────────────────────────┐
  702. │ NOTES ABOUT HANDLING FILES     │
  703. └────────────────────────────────┘
  704.  
  705.  
  706. Files are always sorted by name in File Handler.
  707. In a future release sorting will be available by
  708. date-time, size, or no sorting at all.
  709.  
  710. FH will only work with 1000 files per directory. If
  711. you have more than 1000 files in one directory -
  712.  
  713.    1) Congratulations.
  714.  
  715.    2) FH will only work with the real first 1000 files
  716.       in that directory.  This means that the sort on
  717.       the filenames doesn't occur until all the files
  718.       in the directory which can fit in the buffer are
  719.       loaded.  If you delete files (or move files) so
  720.       that less than 1001 files remain, then of course
  721.       File Handler will be able to load the entire
  722.       directory.
  723.  
  724.  
  725.  
  726.  
  727. ┌─────────────┐
  728. │ DIRECTORIES │
  729. └─────────────┘
  730.  
  731.  
  732. Handling Directories is even more straightforward
  733. than file handling.  You don't even have to be in
  734. the parent directory to remove one of its subs.  It
  735. must be an empty directory, however.
  736.  
  737. The command for removing a directory is [ctrl-v], and
  738. to make a directory, [ctrl-k].  You will prompted
  739. afterwards, if you want to remove or make more.
  740.  
  741.  
  742. Remember this: The Control Key is used exclusively
  743. for handling Directories in File Handler.
  744.  
  745.  
  746.  
  747.  
  748. ┌────────────────────────┐
  749. │ THE SEARCH UTILITY     │
  750. └────────────────────────┘
  751.  
  752.  
  753. One of the most powerful features of File Handler,
  754. is the Search routine.  [Alt-s] prompts you to enter
  755. a mask, and then sets about searching the entire
  756. logged drive for matching files.  After it has
  757. completed its search, you may do several things.
  758.  
  759.  
  760. Each directory with matching files is shown one after
  761. another, and you may page through each directories'
  762. found-files with the [pgup]/[pgdn] keys, or use the
  763. [up]/[dn] arrows to scroll through the filenames in
  764. each directory list.
  765.  
  766. You may press [F4] to exit to the directory
  767. currently being displayed.
  768.  
  769. Or, you may Move, or Copy all the found-files to a
  770. common location, such as a floppy diskette or another
  771. directory, or drive.  Or you may Delete all found-files
  772. on the entire drive.
  773.  
  774. Fortunately, you may exclude a directories' files from
  775. being acted upon when the program gets to that directory.
  776.  
  777.  
  778. WARNING!!!!!WARNING!!!!!WARNING!!!!!
  779.  
  780. PLEASE use this powerful ability carefully!
  781.  
  782. It's not for the faint of heart.  If you move all
  783. your .EXE files to C:\IDIOT, then you will have a
  784. problem when you try to run any of those programs
  785. and they no longer can be found in your path.  You
  786. can also delete files quickly and the program won't
  787. be forgiving in these circumstances.  Copying is
  788. not very dangerous.
  789.  
  790. I cannot be responsible if you use this program to
  791. destroy your File System!
  792.  
  793.  
  794.  
  795. ┌──────────────────┐
  796. │ EXIT and EXECUTE │
  797. └──────────────────┘
  798.  
  799.  
  800. FH has no shell capability, because "Shelling to DOS"
  801. while files are being directly manipulated at the
  802. FAT level is dangerous.  Also, if files are changed,
  803. deleted et cetera, while shelled out- upon return FH
  804. would have invalid information available to it, which
  805. is even more dangerous.  Because of this, File Handler
  806. will exit out to the FH.BAT file which handles the
  807. DOS ErrorLevel, giving you the ability to run
  808. external programs from "within" FH.
  809.  
  810.  
  811. The FH.BAT file will restart FH, returning you to
  812. the directory you were most recently logged to,
  813. (unless "\" or other path-specifier was entered on
  814. the original command-line) while retaining the name
  815. of the directory from which you originally started FH,
  816. allowing you to return there after finally exiting
  817. File Handler.
  818.  
  819.  
  820. FHMAIN.EXE could be run without the FH.BAT file,
  821. but doing so prevents FH from using the Exit and
  822. Execute facility, and also requires the use of
  823. the "@drive:\path" switch on the command-line.
  824.  
  825. (Use "/?" on the command-line for more information.)
  826.  
  827.  
  828. At the Main screen of FH, press the combination
  829. [alt-e] to bring up a prompt to enter the full
  830. command, or you may tag a file (an executable,
  831. such as one with an extension of .EXE, .COM or
  832. .BAT).  Then press [enter].  Or at the prompt,
  833. key in any command-line parameters required
  834. to run the external program.
  835.  
  836.  
  837. Including "#P" in the command-tail causes a PAUSE
  838. before returning to FH.  Any other parameters added
  839. to the command-tail will be passed on to the external
  840. program.  If you make an error on the command-line,
  841. FH will normally restart immediately.
  842.  
  843.  
  844. You may have a particular set of commands you would
  845. like to execute often.  In this case you may want to
  846. take advantage of the FHD.BAT file.  Change this file
  847. for your own use, and from within FH press [ctl-e] -
  848.  
  849.  
  850. Do NOT distribute any FHD.BAT that you have altered!  It
  851. would definately be confusing to anyone else that
  852. aquired my program from you further down the road,
  853. and is also illegal to do so.  FHD.BAT is an example
  854. batch file, and should be updated to include your
  855. most used command(s).  For instance, you may want to
  856. place a command to begin your Communications program
  857. from the FHD.BAT.  Then to execute your Communications
  858. program, simple press [crtl-e] then [enter].
  859.  
  860. The text of FHD.BAT is included below.  Please compare this
  861. to the actual copy of FHD.BAT which you received in your
  862. archived copy of File Handler.  If there is anything added
  863. or missing from your FHD.BAT, please know that someone has
  864. altered your copy of this archive, in which case you ought
  865. to suspect the worst and get a fresh copy of FH from one
  866. of my ODS's listed below.
  867.  
  868. {------------------------------ cut -----------------------------------}
  869. @echo off
  870. : This is an example batch file.
  871. : Place whatever favorite command(s) you would like to be able to use
  872. : from "inside" File Handler.
  873. : From the Main Screen within FH, press [ctl-e] to run this batch file.
  874. echo This batch file is an example batch file to be edited by the user
  875. echo of File Handler.  It can be run from within FH by pressing [ctl-e]
  876. echo while at the Main Screen.
  877. echo.
  878. echo You may alter this batch file to your liking. But if you distribute
  879. echo File Handler you must use this original with the distributed copy.
  880. echo See FH.DOC for more details on registration and licensing.
  881. pause
  882. {------------------------------ end -----------------------------------}
  883.  
  884.  
  885. Some examples of how you may use [alt-e] :
  886.  
  887. If you want to format a diskette in drive A, and pause
  888. before FH restarts after the format is finished:
  889.  
  890. First, insert the diskette in the drive and from
  891. File Handler's Main Screen, press [alt-e].  At the
  892. prompt key "FORMAT A: #P" [enter].  You could just
  893. as well key "#P FORMAT A:" or even "FORMAT #P A:"
  894. (do NOT key in the quote (") marks, however).  FH
  895. will Exit, and then Execute from the DOS prompt
  896. FORMAT A: <cr>. Afterwards will prompt for you to
  897. press a key to return to File Handler.  FH restarts
  898. with the same command-line parameters you started
  899. FH with originally.
  900.  
  901. Assume you have just downloaded a "ZIP" file.  You
  902. want to get in quickly and find out what this new
  903. program is like:
  904.  
  905. From FH's main menu screen, you change to where this
  906. new file is.  Press [alt-e] and at the prompt enter:
  907.  
  908.         "PKUNZIP NEWFILE.ZIP C:\TEMP"
  909.  
  910. After pressing the [enter] key, FH exits and then
  911. executes the command-line. Afterwards you return
  912. to FH, and change to the C:\TEMP directory. You see
  913. a .DOC file, a README file, and a couple .BAT files.
  914. You tag them, and press [alt-t] to view them.  After
  915. reading them, you've found out that to install it you
  916. need to run NEWINST.EXE, but first you want to run your
  917. virus scanner to check these files for viruses.
  918. So you press [alt-e], enter your virus software's command-
  919. line, and press enter.
  920.  
  921. Everything seems to be okay so far, so you tag
  922. the NEWINST.EXE file and press [alt-e] to
  923. exit and execute it.  Once that install program
  924. is finished, you can run your new program by using
  925. [alt-e] once again.
  926.  
  927. As you can tell, FH is very flexible indeed.
  928. Other programs do this kind of thing, but FH is
  929. different in that it completely exits before executing
  930. any other programs.  This allows your other programs
  931. to have the RAM they deserve.  You can even change
  932. your system's environment by using the [alt-e]
  933. command.
  934.  
  935.  
  936.  
  937. IMPORTANT:  The hot-keys [alt-e] and [ctl-e] are NOT
  938.             included on the "Action" menu, or listed
  939.             anywhere in the program, per se.  Help
  940.             for Exit and Execute is available using
  941.             the [F1] key, however.
  942.  
  943.  
  944.  
  945.  
  946.  
  947. ┌────────────────────────┐
  948. │ PROGRAM CONFIGURATION  │
  949. └────────────────────────┘
  950.  
  951.  
  952. Use [F3] to configure your colors.  Any of the
  953. basic 16 colors are allowed.  You will need to
  954. decide if you want to be able to read your screen
  955. or not.  Save your setup with [F10].  Pressing [TAB]
  956. will move you to the Screen Saver time index.  The
  957. default is 5 minutes, but can be set to as high as
  958. 254 minutes.  Press enter and you are returned to
  959. the color configuration process.  Pressing [F3]
  960. from within the color configuration menu, takes you
  961. to the Program Settings.
  962.  
  963. Please use the [F1] help key on the Program Settings
  964. screen for detailed help and explanations for the
  965. various program settings.
  966.  
  967.  
  968.  
  969.  
  970. ┌───────────────┐
  971. │ GENERAL NOTES │
  972. └───────────────┘
  973.  
  974.  
  975. Most of the "hot-keys" listed above are shown with
  976. their uses, on the "Action" Menu.  Use the "Action"
  977. Menu when you can't remember what commands to use.
  978. It won't be long before you will have all the keys
  979. memorized and the "Action" Menu will be all but
  980. unnecessary.  Help is "context sensitive" and, when
  981. available, is accessed with [F1].
  982.  
  983.  
  984. I'm certain that once you have become familiar with
  985. how FH works, and how easy it makes dealing with a
  986. complex file system, you will enjoy using the program
  987. for almost everything.
  988.  
  989.  
  990. Back in 1987 I wrote a program distantly related to
  991. this one, which I also dubbed File Handler.  I never
  992. intended to pass it around, so it wasn't as flexible
  993. as this one.  I did like being able to see my directories
  994. and delete files with it, which is about all it could
  995. do.  This File Handler program is radically different
  996. from what I wrote in 1987 for my own personal use.
  997.  
  998. One thing about File Handler which is unique, is its
  999. simplicity.  I fully intended to make it simple, so
  1000. even my dad could use it.  It won't bother with
  1001. using EMS or XMS, operates entirely in real-mode so
  1002. that it is compatible with every PC including the
  1003. original IBM-PC, and won't hog RAM.  It doesn't have
  1004. myriads of program settings to confuse.  And it
  1005. doesn't revector all your computer's interrupts; so
  1006. it won't be incompatible with communication software,
  1007. fossil drivers, cache programs, TSR's or anything.  It
  1008. will work fine with redirected logical drives, using
  1009. DOS to identify them.
  1010.  
  1011. This program has been tested on the original IBM-PC,
  1012. all the way through to a Pentium equipped computer.
  1013. It operates consistently on all DOS based systems,
  1014. including PS/2's with the MCA bus.  The speed of
  1015. this program is rather suprising, even on the
  1016. 4.77Mhz 8088.  You will notice an additional
  1017. improvement in speed if you have a cache program
  1018. running concurrently.
  1019.  
  1020. The added feature to Exit and Execute makes FH a
  1021. flexible program indeed; allowing you to use it
  1022. as a type of Menu program.  I invite you to try
  1023. it out in this manner; I believe you will enjoy
  1024. it even more.
  1025.  
  1026.  
  1027. Send your registration payments and comments to:
  1028.  
  1029.  
  1030.     Mark Bloss, aka Sin Tacks
  1031.     313 Hooper Court
  1032.     Nashville TN  37211
  1033.     mark.bloss@129.basement.raider.net
  1034.     FidoNet 1:116/129
  1035.  
  1036.  
  1037.     Official Distribution Sites:
  1038.  
  1039.     The Common Wavelength BBS
  1040.     Dave Parsons, Sysop
  1041.     1018 Lone Oak Road
  1042.     Mt. Juliet, TN  37122
  1043.     (615)832-1541
  1044.  
  1045.     The Northern Lights BBS
  1046.     Jeff Jenkins, Sysop
  1047.     FidoNet 1:116/129
  1048.     Nashville, TN
  1049.     (615)831-9284
  1050.  
  1051.     UltraTech CBCS
  1052.     Jack Smith, Sysop
  1053.     FidoNet 1:116/30
  1054.     Nashville, TN
  1055.     (615)356-0453
  1056.  
  1057.  
  1058.  
  1059. Thanks for Using File Handler!
  1060.  
  1061. 
  1062.